home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / locate.1 < prev    next >
Encoding:
Text File  |  1994-07-31  |  2.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LOCATE(1L)        MISC. REFERENCE MANUAL PAGES         LOCATE(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      locate - list files in databases that match a pattern
  10.  
  11. SYNOPSIS
  12.      locate [-d path] [--database=path] pattern...
  13.  
  14. DESCRIPTION
  15.      This manual page documents the GNU version of  locate.   For
  16.      each given pattern, locate searches one or more databases of
  17.      file pathnames and displays the pathnames that  contain  the
  18.      pattern.   Patterns  can contain shell-style metacharacters:
  19.      `*', `?', and `[]'.  The metacharacters do not treat `/'  or
  20.      `.'  specially.  Patterns that contain metacharacters should
  21.      be quoted to protect them from expansion by the shell.
  22.  
  23.      If a pattern is a plain string - it contains no  metacharac-
  24.      ters  -  locate  displays all pathnames in the database that
  25.      contain that string anywhere.  If  a  pattern  does  contain
  26.      metacharacters,  it  only  displays pathnames that match the
  27.      pattern exactly.  As a result, patterns that  contain  meta-
  28.      characters  should  usually  begin with a `*', and will most
  29.      often end with one as well.   The  exceptions  are  patterns
  30.      that  are  intended to explicitly match the beginning or end
  31.      of a pathname.
  32.  
  33.      The filename databases contain lists of the files that  were
  34.      on  the  system whenever the database was last updated.  The
  35.      pathname of the default database, the frequency  with  which
  36.      it  is  updated,  and  the directories for which it contains
  37.      entries are configurable by the system administrator.
  38.  
  39.      locate supports  having  multiple  filename  databases;  for
  40.      example,  there  could  be  one on each filesystem.  You can
  41.      tell locate to use alternate filename databases  instead  of
  42.      the default one by giving a colon-separated list of database
  43.      pathnames as either an argument  to  the  -_d  or  --_d_a_t_a_b_a_s_e
  44.      options   or  as  the  value  of  the  environment  variable
  45.      LOCATE_PATH.  The option overrides the environment  variable
  46.      if both are used.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.